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TCL_PLI, a Framework for Reusable, Run Time 
Configurable Test Benches 



The invention relates to application specific integrated circuits (ASICs). More 
particularly, the invention relates to a framework for reusable, run time 
configurable test benches for the verification of ASIC designs. 



As ASIC complexity keeps increasing, the time spent in design and maintenance 
of test benches has grown to become a disproportionately large part of the total 
design effort. In an ASIC verification engine, such as provided by Verilog, test 
benches have become slow to compile and cumbersome to maintain. 

The traditional approach to test bench development and ASIC verification is to 
write a single test bench that contains a number of tasks that exercise different 
aspects of the designs. Team members add new tasks as the verification effort 
continues, and tests are run by calling different sets of tasks in different order, 
depending on the functionality being tested. 

One problem with this approach is that the test bench must be recompiled for 
every new simulation. Even though compiled simulators offer features such as 
incremental compilation, in which only the code that changed is recompiled, this 
still means that a lot of time is spent compiling test benches. 

Initial efforts to reduce this problem involved using configuration files. In this 
approach, one tries to make the test bench code to be all things to all people. 
Test benches typically contain complicated case statements and if-then-else 
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sequences. These are controlled by parameters that are read from a text 
configuration file when the simulation is launched. 

This approach eliminates the need to recompile test benches repeatedly, but 
introduces an even worse problem, i.e. test benches become extremely 
complicated, very difficult to maintain, and very application specific. Often, when 
new functionality is added to a test bench, it has side effects that cause other 
tests to break. At the end of the project, one has a test bench that very few 
people understand, and that is so convoluted that there is no possibility of reuse. 



It would be advantageous to provide an approach to ASIC verification in which 
test benches do not become extremely complicated, very difficult to maintain, or 
very application specific. It would be of additional advantage in such approach if, 
when new functionality is added to a test bench, it does not introduce side effects 
15 that cause other tests to break. Further, at the end of the project, one should 
have a test bench that anyone can understand, and that is not so convoluted that 
there is no possibility of reuse. 



U 

O SUMMARY OF THE INVENTION 

S20 

O A scripting approach to managing the test bench complexity issue is provided. 
Partitioning the functionality of a test bench between Verilog and a scripting 
language allows for a significant reduction in compile times during ASIC 
verification. If done correctly, partitioning also offers great potential for re-use of 
25 test bench components. 

The Tel language was chosen as a basis for implementing a library of PLI 
routines that allow fully customizable interpreters to be instantiated in Verilog test 
benches. This library allows multiple Tel interpreters to be instantiated in a 
30 Verilog simulation. The Tel interpreters can interact with the simulation and 
cause tasks to be executed in the Verilog simulation. 
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It has been found the TCL_PLI library is extremely valuable in speeding up 
verification efforts on multi-million gate ASICs. 

BRIEF DESCRIPTION OF THE DRAWINGS 

Figure 1 is a block schematic diagram that illustrates the required interaction 
between the Verilog simulation and a Tel interpreter according to the invention. 

DETAILED DESCRIPTION OF THE INVENTION 



The invention provides a solution to the problem of providing a reusable test 
bench for ASIC design verification by making the configuration files more 
powerful, so that some of the complexity that is coded in Verilog is shifted over to 
% something that is evaluated at run time. In essence, a scripting language is 
15 provided that interacts with the simulation. 



With this approach, one can design a simple test bench which contains a number 
of tasks that handle low level interaction with the device under test. If these 
tasks are called from a scripting language, one can develop different verification 
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p20 scripts; each test tailored to verifying a specific aspect of the design. 

M 

Q 



? A key difference from the prior art configuration file approach is that the 
intelligence that determines the ordering of events is moved from Verilog to a 
script file that is interpreted at run time. Different people can use the same test 

25 bench to test a design in completely different ways. They have the benefit of 
significantly reduced need for recompilation, and different people on the 
verification team can be completely insulated from one another. Each person 
can develop their own verification script, and changes to that script only affect 
their own simulations. 
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Tel as a choice of scripting language 

The initial approach taken was to extend the configuration files that were already 
in use to handle simple conditional and looping constructs, and to extend the PLI 
routines that were in use to process these configuration files to become a simple 
5 interpreter. 

It was decided to investigate the feasibility of using Tel as a scripting language 
(see J. Ousterhout, Tel and the Tk Toolkit , p. xvii, Addison-Wesley, (1994)). This 
turned out to be a very good idea. After many attempts to write custom 
10 interpreters for various tools, it was decided to write the ultimate, reusable and 
„ embeddable interpreter. Tel appeared to have all the characteristics that are 
necessary to implement the invention, i.e. it was already developed, it was free, it 

fU was easily extendable, and it was easy to embed in an application. 

M 

ry 

« The obstacle 

5 15 There was a problem to overcome: 

yy 

~j The Verilog language is extended through function calls. If a user needs new 
C functionality, it is implemented in C, and the PLI API is used to make it available 

as a new function that can be called from Verilog. Tel is also extended through 
20 function calls, but new functionality is implemented in another compiled language 

(typically C) and is linked into Tel as a new Tel function. 

A system was implemented in which the Verilog simulation starts up a Tel 
interpreter and instructs it to run a script. This implied a PLI function call. At 
25 some point the Tel interpreter encounters a function that is mapped to a certain 
Verilog task. It then must pass control back to Verilog so that the task could be 
executed. This implies that the PLI call that invokes the interpreter must return, 
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leaving the problem of how to resume execution of the Tel script after executing 
the Verilog task. 



In addition to extending the functionality of configuration files through the use of a 
5 scripting language, it was necessary to invent a system through which one could 
pass control between Verilog and Tel, through function calls on either side. In 
this way, the Verilog code controls when Tel interpreters are invoked, but the Tel 
interpreters cause Verilog tasks to be executed (implying that a PLI call needs to 
return), while retaining the state of the Tel interpreter so that it could resume 
10 execution of the Tel script after the Verilog task completed. 



The solution 

The preferred embodiment of the invention solves this problem by implementing 
fU a simple client-server model, in which the Tel server runs on a separate thread 
Jj] 15 from the Verilog simulation. Figure 1 is a block schematic diagram that illustrates 
g the required interaction between the Verilog simulation 10 and a Tel interpreter 
a 20. Synchronization between the Verilog simulation and the Tel server is 
y performed via a set of semaphores. This allows control to be passed freely 
^ between Verilog and Tel. The Verilog code determines when Tel interpreters are 
Q20 invoked and Tel interpreters can randomly cause Verilog tasks to be executed. 
Thus, a PLI function call executes a Td script (100), a C function call executes a 
Verilog task (110), and a PLI function call resumes script execution (120). 

The TCL_PLI library allows any number of Tel interpreters to be instantiated in a 
25 Verilog simulation. Every interpreter is completely customizable. PLI functions 
initialize interpreters and define new Tel functions that are mapped to Verilog 
tasks. PLI functions also start running scripts on the Tel interpreters and pass 
control between Verilog and Tel. 
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The Verilog tasks have access to arguments passed to the Tel functions that 
invoked them, allowing information to be passed from Tel to Verilog. The Verilog 
tasks also have the ability to control the return values of their Tel counterparts, 
allowing information to be passed from Verilog to Tel. PLI routines are also 
provided that allow direct sharing of information between Tel and Verilog, as well 
as between different Tel interpreters. 

Interaction between Verilog and Tel 

At the core of the TCL_PLI library are four PLI functions: Stcllnit, $tclExec, 
StclGetArgs, and $tclClose. 



• Stcllnit creates and initializes a new Tel interpreter. It defines the new Tel 
Lji functions that are used to invoke Verilog tasks, maps them to specific tasks, 



^ and defines how many arguments they take. 



S15 • StclExec passes control from Verilog to the Tel server. It launches a new 

p script or resumes execution of a script that was stalled when the interpreter 

jjj encountered a function that was mapped to a Verilog task. StclExec returns 

S! under one of three conditions: when an error occurs, when the script ends, or 



when a function is encountered that is mapped to a Verilog task. 

StclGetArgs accesses the argument values that -were passed to an extended 
Tel function. 



• StclClose destroys a Tel interpreter and frees the resources with which it is 
25 associated. 

The following code segment (Table A) shows how an interpreter is created and 
initialized in Verilog. The interpreter has three extended Tel commands (b_write, 
b__read and b_wait_irq) that are mapped to Verilog tasks. These commands 
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allow scripts running on the interpreter to write data on a bus, read data from a 
bus, or wait for an interrupt to occur on the bus. 

Table A 



1 parameter 

2 BUS_WRITE = 1, 

3 BUS_READ = 2, 

4 BUS„WAIT_IRQ = 3; 

5 initial 

6 begin: processor_model 

7 integer tcl_handle, 

8 tcl_command, tcl_return_value ; 

9 // Initialize interpreter that 

10 // knows about the three 

11 // extended Tel commands: 

12 tcl_handle = $tcllnit ( 

13 "processor", tcl_command, 

14 tcl_return_value, 

15 "b_write" , BUS_WRITE, 2, 

16 "b_read" , BUS_READ, 1, 

17 "b_wait_irq" , BUS_WAIT_IRQ, 0 

18 ) ; 

19 if (tcl_handle == 0) 

20 begin 

21 $display ("Init error."); 

22 $finish; 

23 end' 



On lines 1 to 4, three integer parameters are defined that represent the three 
extended Tel commands in Verilog. Lines 7 and 8 define three variables that are 
used to communicate between Verilog and Tel. tcl_handle stores the handle of 
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this interpreter. Each interpreter has a unique handle. It is returned by the 
$tcllnit PLI function and is used by all other TCL__PLI functions to identify the 
interpreter that is being addressed. tcLcommand is used by TCL_PLI to indicate 
to Verilog which extended Tel function had been encountered while executing the 
5 script. It also indicates the completion status of the Tel script when execution of 
the script ends. tcl_return_value is used by Verilog to communicate the return 
values of tasks back to the calling Tel functions. 

On lines 12 to 18, the call to $tcllnit initializes the interpreter. It identifies the 
10 variables tcLcommand and tcl_return_value to TCL_PLI. It also defines the 

extended Tel functions b_write, b„read and b_wait_irq. $tcllnit associates an 
Q integer value with each extended Tel function and stores the number of 
y=^ arguments that each extended Tel function should expect. $tcllnit can take a 
yj variable number of arguments to allow definition of any number of extended Tel 
HJ 15 functions. 

q The return value of $tcllnit contains the handle of the newly created Tel 

W interpreter. If the value is zero, this is an indication that an error occurred while 

Q 

SI creating and initializing the interpreter. The test on line 19 confirms that the call 

§ 20 to $tcllnit completed successfully. 

The following code segment (Table B) indicates how a script is executed on a Tel 
interpreter and how control is passed between Verilog and Tel. 

25 Table B 

24 while ($tclExec { tcl_handle , 

25 "example. tel") ) 

26 begin 

30 27 tcl_return_value = 0; 
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28 case ( tcl_command) 

29 BUS_WRITE: 

30 bus_write (tcl_handle) ; 

31 BUS_READ : 

5 32 bus_read ( tcl_handle, 

3 3 tcl_return_value) ; 

34 BUS_WAIT_IRQ : 

3 5 bus_wait_irq; 

3 6 endcase 

10 37 end // while 

3 8 if ( tcl_command != 0) 

3 9 begin 

O 40 $display ( 

JJj 41 "Error in Tel script!"); 

fU 15 42 $finish; 

La. 

43 end 

S3 44 $tclClose (tel handle); 

o 

a 45 end // processor_model 

u 

O 20 When $tclExec is encountered the first time (line 24), the Tel server is idle. This 

S3 ' ' 

□ is an indication that it should start executing the script "example. tcl". As 

O 

™ mentioned earlier, $tclExec returns under one of three conditions: if an error 
occurs, if the script ends, or if an extended Tcl function is encountered. A non- 
zero return value indicates that an extended Tcl function had been encountered. 
25 A return value of 0 indicates that the script has ended or that an error occurred. 
In the case where an extended Tcl function is encountered, the Tcl interpreter 
stalls until the next call to $tclExec informs it that the Verilog task has been 
executed. 

30 The while loop (lines 24 to 37) continues looping as long as the return value of 
$tclExec remains positive. This means that the simulator continues executing 



9 



Attorney Docket No. B0O252 



10 



Verilog tasks as they are encountered in the Tel script that is being executed. If 
$tclExec is called when the Tel server is not idle, it assumes that execution of the 
current script should continue. $tclExec checks that the script name passed to it 
matches the name of the script being executed and returns an error value if this 
is not the case. 

Not all Verilog tasks have meaningful return values. Therefore, tcl_return_value 
is initialized to zero to ensure that an undefined value is not eventually returned 
to the Tel interpreter (line 27). 

Whenever $tclExec returns a non-zero value, the tcl_command variable contains 

S the integer value corresponding to the extended Tel function that was 

if%i encountered in the script. The case statement on line 28 calls the Verilog task 

^ associated with this Tel function. 

fU 15 

Pj Once the Verilog task completes, the while loop continues with another call to 

g $tclExec. $tclExec again returns when it encounters an extended Tel command, 

UJ reaches the end of the script, or encounters an error. The result is that the while 

S 

Sj loop causes the whole Tel script to be executed, and Verilog tasks are called in 

q 20 the order determined by the execution of the Tel script. 

When the while loop terminates, it is appropriate to check that no error occurred 
(line 38). When $tclExec returns zero (causing the while loop to terminate), the 
tcLcommand variable contains an exit code indicating either normal termination 
25 (end of script reached) or abnormal termination (due to an error in the script). 

At this point, the Tel interpreter can be deleted if it is no longer required (line 44). 
It should be noted that the same interpreter can be used repeatedly. Scripts can 
also be run on the interpreter from different points in the Verilog code. TCL_PLI 
30 generates an error if an attempt is made to run multiple scripts on one interpreter 
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simultaneously. Interpreter state information (such as variable values and 
procedure definitions) is preserved until the interpreter is destroyed through a call 
to $tclClose. 



The following code segment (Table C) shows the definition of the Verilog tasks 
that are called under control of the Tel interpreter. 



Table C 

49 task bus_write; 

50 input [31:0] tcl_handle; 

51 integer address, data; 

52 begin 

53 $tclGetArgs (tcljiandle, 

54 address , " i " , 

55 data, "i" 

56 ) ; 

57 // Simulate the write cycle 

58 //on the bus - 

59 end 
60 

61 task bus_read; 

62 input [31:0] tcl_handle; 

63 output [31:0] data; 

64 integer address; 

65 begin 

66 $tclGetArgs (tcl_handle, 

67 address, "i" 

68 ) ; 

69 // Simulate the read cycle 

70 //on the bus 

71 data = data_read_f rom_bus ; 

1 1 
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72 end 
73 

74 task bus_wait_irq; 

7 5 begin 

7 6 @ (bus_irq) ; 

77 end 



A Verilog task can gain access to the arguments of the Tel function by which it is 
invoked. For this purpose, the handle of the interpreter is passed to these tasks 
(line 50). A call to StclGetArgs is used to transfer this information from Tel to 
Verilog (line 53). StclGetArgs can handle integer or string arguments, and 
performs the appropriate conversions. 

The bus_read Verilog task illustrates how the return value of a Tel function is set 
up in the Verilog task (lines 71 and 33). TCL_PLI assumes that the return value 
is an integer. The bus_wait_irq task illustrates a simple case where the Tel 
interpreter can be stalled while waiting for an event in the simulation (line 76). 

The following (Table D) is a sample Tel script that can be run in the Verilog 
example shown above. It illustrates how the execution order of the Verilog tasks 
are completely controlled from Tel. In essence, the Tel script is in complete 
control of the simulation in the same way that software controls the hardware on 
which it is run. 



Table D 



1 # Write to a register, wait 

2 # for an interrupt and read back 

3 # a cause: 

4 puts " $::vname @ $::vtime: \ 

1 2 
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5 Writing Oxaa to address 0x05:" 

6 b_write 0x05 Oxaa 

7 puts " $::vname @ $::vtime: \ 

8 Waiting for interrupt..." 
5 9 b_wait_irq 

10 puts "$:: vname @ $::vtime: \ 

11 Interrupt received" 

12 puts [format "Address 0x05 now \ 

13 contains %x" [b_read 0x05]] 
10 14 

15 # Write to another register, 

16 # then poll until bit 1 changes: 
Q 17 puts "$::vname @ $:: vtime: \ 

18 Writing Oxff to address 0x0a: " 

15 19 b_write 0x0a Oxff 

20 set bit 1 0x0 
iy — 

IS 21 while {$bit_l} { 

B 22 # Read 0x0a and check the LSB: 

s 23 set bit_l \ 

UJ 

p 20 24 [expr [b_read 0x0a] && 0x01] 

SJ 

^ 25 puts "$::vname @ $::vtime: \ 

Q 26 Bit 1 value is $bit_l" 

27 } 

28 puts "$: :vname @ $::vtime:\ 
25 29 Value changed!" 



The variables vname and vtime are defined by the TCL_PLI library, vname 
contains the name of the interpreter (passed as the very first argument to 
$tcllnit). It is useful to determine the source of a message, vtime contains the 
30 current simulation time, which is very useful for tracing simulator messages back 
into waveforms. 

■ 1 3 
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Behind the scenes 

As mentioned previously, the Tel interpreter is run on a separate thread from the 
Verilog simulation. A call to $tcllnit causes a secondary thread to be created, on 
which the Tel server runs. The Tel server creates and initializes a new Tel 
interpreter, and then enters a loop in which it waits for and executes commands 
received from the PLI functions. 

The following C code segment (Table E) is a simplified version of the command 
loop in the Tel server. 



Table E 



1 /* Wait for and service requests 

2 to run scripts */ 

3 runServer = 1 ; 

4 while (runServer) 

5 { 

6 /* Pass control to the Verilog 

7 thread */ 

8 sem_post (&t->t2v) ; 

9 /* Wait for an instruction from 

10 the Verilog thread */ 

11 sem_wait (&t->v2t) ; 

12 switch { t->server Command) 

13 { 

14 case TC_RUNSCRIPT : 

15 t->serverStatus = 

16 tclServer_runScript (t) ; 

17 break; 

18 case TC_CLOSE: 

14 
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19 runServer = 0; 

20 t->serverStatus = TS_D0NE; 

21 break; 

22 case TC_ADDCOMMAND : 

5 23 /* Add new commands to 

24 interpreter */ 

25 break; 

26 case TC_LINKVARS : 

27 /* Link with Verilog 
10 28 variables */ 

29 break; 

3 0 case TC_SHAREVARS : 

p 31. /* Link with variables from 

32 other interp */ 

t\i 15 33 } 

3 s 

m 



34 } 



a Once the Tel server is initialized, it enters the command loop and immediately 

y posts the t2v semaphore to the PLI to indicate that it is ready to accept a 
O 20 command. It then waits for the v2t semaphore. Upon receipt of the v2t 
O semaphore, it examines the serverCommand member of its defining structure to 
U determine what command was issued and executes the command. When the 
command is completed, the loop starts again. 

25 On the Verilog thread, a PLI function sends a command to the Tel server by 
setting up the serverCommand member of the server's defining structure and 
then posts the v2t semaphore. The PLI function then waits for the t2v 
semaphore as an indicator that control is being passed back to Verilog. 

30 The following sequence takes place if the Tel script in the previous example is 
executed: 
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• When $tclExec is called from the Verilog simulation the first time (Tel server is 
idle), it instructs the Tel server to start executing the script, and then waits for 
the t2v semaphore. The Tel server executes lines 1 through 5 of the script. 
When it reaches line 6, which contains the extended command b_write, it 
calls the function tclServer^verilogCall. This function is called for all extended 
commands that are mapped to Verilog tasks. tclServer_verilogCall saves the 
relevant information in its defining structure, posts the t2v semaphore, and 
then waits for the v2t semaphore. 

• When $tclExec receives the t2v semaphore, it synchronizes linked variables 
and returns to Verilog. This allows the simulator to enter the while loop in 
which it executes the tasks associated with extended Tel functions (lines 24 to 
37 of the Verilog example). When the task associated with b_write 
completes, $tclExec is again called. This time the Tel server is not idle, so 
$tclExec assumes that execution of the script should resume. It synchronizes 
linked variables, posts the v2t semaphore, and waits for the t2v semaphore. 

• tclServer_verilogCall receives the v2t semaphore and returns, allowing 
execution of the Tel script to continue. This process repeats itself until the 
script completes. When this happens, the Tel server indicates this to the PLI 
when posting the t2v semaphore. This time, when $tclExec returns, the 
Verilog while loop terminates. 

The following C code segment (Table F) shows a simplified version of 
tclServer_verilogCall, the function that is called by the Tel interpreter when it 
encounters an extended command. 



Table F 



1 6 



Attorney Docket No. 252 



1 int tclServer_verilogCall (...) 

2 { 

3 /* Store the command value for 

4 the Verilog thread */ 
5 5 t->commandValue - 

6 command- >va lue ; 

7 /* Store the argument array 

8 and count in the interpreter 

9 struct to make it accessible 
10 10 to tclGetArgs: */ 

11 t->argc = argc; 

12 t->argv = argv; 

q 13 /* Semaphore verilog */ 

*0 14 sem_post (&t->t2v) ; 

Ul 

py 15 15 /* At this point control has 

p 16 been passed back to Verilog, 

SB 17 where the functionality is 

18 being simulated. Once done, 

O ' 19 the main thread will 



q 20 20 semaphore this thread to 



U 

Q 

M 21 continue. */ 

g 22 /* Wait for semaphore from 

23 verilog */ 

24 sem_wait (&t->v2t) ; 

25 2 5 /* Set up the return value */ 

26 sprintf (message, "%d" , 

27 t->retVal); 

28 Tcl_SetResult (t->interp, 
' 29 message, TCL_VOLATILE) ; 

30 3 0 return TCL„OK; 

31 } 
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It is important to note that, even though TCL_PLI is multi-threaded, and that 
every interpreter is run on a dedicated thread, the essential single threaded 
nature of Verilog simulations is maintained. Only one call to $tclExec can be 
reached in the Verilog simulation at any given time. The Verilog simulation stalls 

5 until this call returns, which occurs when the Tel interpreter calls 
tclServer_verilogCall or when the script completes. tclServer_verilogCall, on its 
part, only returns when the next call to $tclExec is encountered in the Verilog 
simulation. This means that, even though many Tel scripts may be in the 
process of execution at any given moment in time, only one of them or the 

10 Verilog code itself is running at that moment. All event scheduling and execution 
order is still under the control of the simulator. 



U 



It should also be noted that the Tel server executes scripts in zero simulation 
time. Simulation time does not advance for the duration of a call to $tclExec. 
fy 15 Simulation time advances normally while the Verilog tasks invoked from Tel are 
= executed 

3 

Q The TCL PLI library 

O 

SJ The following discussion provides a brief overview of the PLI functions available 
q in the EFI_PLI library. The $tcllnit, $tclClose, $tclExec and $tclGetArgs PLI 
20 functions have already been discussed in detail and are not listed again in this 
section. 

StclLinkVariables and $tclShareVariables 

StclLinkVariables allows direct sharing of variables between Verilog and Tel. It 
links a list of Verilog variables with a list of Tel variables. The TCL_PLI library 
25 then automatically keeps these variables synchronized until the interpreter is 
deleted. StclLinkVariables has support for integer and string variables, and can 
mark variables as read-only in the Tel interpreter, meaning that they can be 
modified in Verilog, but not in Tel. 

1 8 
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StclShareVariables allows direct sharing of variables between two different Tel 
interpreters, without any connection to Verilog. After a call to StclShareVariables, 
the list of Tel variables in both interpreters are automatically synchronized by the 
5 TCL_PLI library, until one of the interpreters is deleted. 

StclSetMCD and StclAddMCD 

StclSetMCD and StclAddMCD allow the Tel interpreter access to multi-channel 
descriptors in the Verilog simulation. This allows the user to redirect messages 
from the Tel interpreter into log files that also record messages directly from the 
10 simulation, which is critical for preserving the order in which messages were 
l=i generated. Any Verilog multi-channel descriptor can be associated with a Tel 
j0 interpreter. If an interpreter has an associated MCD, its built-in puts command is 
fli modified, causing all output to stdout to be redirected to the multi-channel 
py descriptor. This makes it very easy to open a log file and set up an MCD that 
® 15 causes all messages from the simulation (both from Verilog and Tel) to be printed 
a to stdout, as well as being recorded in a log file. 



UJ 

M 

n 



StclSetErrorReg 

StclSetErrorReg allows the user to identify one register in the Verilog simulation 
that is linked to any error occurring in any interpreter or in TCL_PLI. If any error 
20 occurs, the value of this register is changed, allowing the simulation to react to 
the error immediately. 

StclWarnOnX 

As with any software language, Tel has no concept of X or Z values. The default 
behavior of TCL_PLt causes execution of the Tel script to be terminated under 
25 any of the following conditions: 
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If the return value of an extended Tel function is X or Z, or if any linked variable is 
X or Z at a point where it is evaluated in the script. 

For purposes of the preferred embodiment of the invention, this is correct and 
5 desirable behavior. In the presently preferred embodiment of the invention, X 
and Z values should never propagate into the software domain because software 
can not handle these values. However, some users of TCL_PLI do not share this 
opinion, and hence the existence of StclWarnOnX. Calling $tclWarnOnX causes 
TCL_PLI to print a warning message under any of the previously described 
10 conditions. Execution of the script continues. If the variable in question is an 
integer, its Tel value is considered to be zero. If it is a string, its Tel value is "Zz". 

|j Note that only a warning message is generated. In a simulation that prints many 
messages, this message can easily scroll off the screen before being noticed. 
fU 15 The misinterpretation of the Verilog value in Tel can ultimately cause all sorts of 



P 



strange behavior and may cause problems the user who decides to use 
StclWarnOnX. 



Q Example: PCLTCL 

M 

p The preferred embodiment of the invention includes a module that instantiates 
20 Synopsys LMC source models for a PCI master and a PCI slave together with 
two Tel interpreters. The tasks supplied with the PCI models are mapped to 
extended Tel functions, allowing one to execute Tel scripts that interact with other 
devices on a PCI bus. The Verilog code causes one of the Tel interpreters to 
start executing a script when it senses an interrupt on the PCI bus. This allows 
25 easy modeling of interrupt service routines written in Tel. Execution of a Tel 
script can be linked to an interrupt by waiting in the Verilog code for the interrupt 
to occur before entering the while loop calling StclExec. 
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The two interpreters in the PCI master have to compete for access to the bus. 
This is accomplished through a simple gating mechanism that checks whether 
the bus is busy before calling a task that starts a transaction on the bus. If the 
bus is busy, it waits for the current transaction to complete before starting the 
new one. This arrangement models actual software behavior very well, where 
several processes running on a CPU have to compete for access to the PCI bus, 
with no guarantee on the order in which accesses takes place. 

The PCI_TCL module allows both interpreters to load data files directly into the 
LMC slave memory (in zero simulation time). Data can also be dumped from the 
slave memory to a file. Both interpreters can execute memory or I/O transactions 
on the bus. Two extended Tel functions are used for bursting commands: the one 
executes the address phase of a burst while repeated calls to the other executes 
one data cycle per call. An encapsulating Tel procedure takes an address, byte 
count, and byte array and performs a corresponding burst read or write on the 
PCI bus by appropriately calling the underlying extended Tel functions. 

The PCI_TCL module allows extensive testing of any PCI based device without 
writing a single line of Verilog code for the test bench. The preferred 
embodiment of the invention also comprises a library of Tel procedures that 
simplifies tasks such as configuration of PCI devices. 

TCL_PLI in practice 

The TCL_PLI library has been used to verify a 600k gate design and is currently 
being used on two designs, both of which are larger than one million gates. All of 
these designs are PCI based ASICs. Using the PCI_TCL module has made it 
possible to write elaborate scripts that interact with the device under test in very 
much the same way as software would interact with the real hardware. 
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Tel interpreters were also used in modules that interact with other ports on the 
device under test. In each case, Verilog tasks were written that know how to 
interact with a port at a low level. The higher level behavior of the test module is 
then controlled by a Tel script. This allows one to change the behavior of test 
5 modules radically by running differing Tel scripts on them. 

In the presently preferred test benches, there typically is a master Tel interpreter 
that controls all test modules that interact with the device under test. It 
determines which Tel scripts are executed when and on what module. This 
10 approach provides centralized control over an extremely configurable test bench. 

Pitfalls 



There are a number of pitfalls to watch out for when using the TCL_PLI library. 
Most important are some issues related to the simulator. The presently preferred 



i — 

pJ embodiment of the invention comprises use of the TCL_PLI library with 



q 15 Synopsys' VCS simulator. With VCS version 4.0.3 it was necessary to compile 
* through C code. VCS allows compilation through C, assembler, or directly to 

Ui object code. Compilation through C is the slowest, but Synopsys advises to 

O 

sj compile through C if using multi-threaded PLI. Not doing this causes immediate 
p core dumps, even when the TCL_PLI library is linked in, but not used. The 
20 presently preferred embodiment of the invention comprises VCS version 5.0.1. 
This version does allow one to compile directly to assembler or object code. It 
should also be mentioned that, other than the penalty of slower compile times, 
VCS 4.0.3 works perfectly well with TCL_PLI. 

25 Following is a list of compile time options for VCS that are needed when using 
the TCL_PLI library: 



• -Xstrict: Prevents VCS from using resources that are used by the multi- 
threading library. 
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• -Ipthread -lposix4: Link with the Posix threading support libraries. 
TCL_PLI has also been used with Cadence Verilog-XL version 2.5. 

5 

One of the most common problems encountered by first-time users, is that they 
forget to assign a default value for the return value register in the while loop that 
executes the Tel script. TCL_PLI has no way to distinguish whether a return 
value is used, and always complains if a return value is X or Z. Therefore, a 
10 default value should always be assigned. A problem that was anticipated, but 
that is not encountered frequently, is with Tel bugs in long running simulations. 
q Because Tel is an interpreted language, a syntax error is only detected when the 
^ interpreter encounters the statement that contains the error. There were 
FU concerns that a simulation could start off that would run very long, only to have it 
jti 15 die near the end due to a bug in the Tel script. The way that this problem is 
presently managed is to develop scripts incrementally, thereby ensuring that 
long-running simulations are performed with proven Tel code. 

Conclusion 

The preferred embodiment of the invention significantly reduces time spent 
20 recompiling test benches. Test benches are a simpler, and consist of modular, 
reusable modules that are easy to maintain. New tests are implemented in new, 
separate scripts, eliminating the problem where addition of new tests causes 
existing tests to break. 
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25 The Tel. scripts themselves are often reusable. When module level testing is 
performed, functionality between Tel and Verilog is partitioned such that the Tel 
scripts are reusable in system level testing. As an example, a Tel interpreter 
interacting with a module uses extended Tel functions that take the same 
arguments and return values as matching functions in the PCI_TCL module, 
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even though it is not interacting with a PCI bus. This way, the scripts that are 
developed for testing the module can be rerun without modification in system 
level tests. 

In one use of the invention, it was possible to reuse a complicated Tel script 
written for a project that was cancelled. The module was initially written to test a 
memory controller by performing random reads and writes and automatically 
verifying data integrity. When it was later necessary to design logic that had to 
access system memory through a PCI bus, the script was reused without 
modification. 

Another embodiment of the invention allows the porting of Tel scripts to real 
hardware. This enables a verification suite to run on ASICs when they return 
from the foundry. 

Although the invention is described herein with reference to the preferred 
embodiment, one skilled in the art will readily appreciate that other applications 
may be substituted for those set forth herein without departing from the spirit and 
scope of the present invention. Accordingly, the invention should only be limited 
by the Claims included below. 



